3D Graphics Programming with QuickDraw 3D 1.5.4

Display Group States

Labels

ASCII: DisplayGroupState
Binary: dgst ( = 0x64677374 )

Display Group State Flags



 
None                    0x00000000

IsInline                0x00000001

DoNotDraw               0x00000002

NoBoundingBox           0x00000004

NoBoundingSphere        0x00000008

DoNotPick               0x00000010

Constant descriptions

None: No flags are specified.
IsInline: The parent group is to be executed inline (that is, without pushing the graphics state on a stack before execution and popping it after execution). This flag is used to prevent the objects in the parent group from inheriting properties specified at a higher level in a hierarchical model containing the parent group. If this flag is set, then objects in the parent group receive only those properties specified in that group.
DoNotDraw: The parent group is not to be drawn when rendering or picking. If this flag is set, then the parent group is not to be traversed when it is encountered in a hierarchical model.
NoBoundingBox: The bounding box of the parent group is not to be used for rendering.
NoBoundingSphere: The bounding sphere of the parent group is not to be used for rendering.
DoNotPick: The parent group is not eligible for inclusion in the hit list of a pick object.

Data Format



 
DisplayGroupStateFlags                  traversalFlags

traversalFlags: A bitfield expression specifying one or more display group state flags.

Data Size

Description

A display group state object is used to specify a set of flags that determines how its parent display group is to be traversed during rendering or picking and whether a bounding box or bounding sphere is to be used during rendering. If a display group does not have a display group state object as a child object, that group's state flags should be set to the default state specified below.

In a text file, a display group state object should be placed together with a group object in the begin group object that immediately precedes that group.

Parent Hierarchy

Data.

Parent Objects

Display group, ordered display group. A display group state object always has a parent object.

Child Objects

None.

Default Display Group State Flags



 
None (= 0x00000000)

Example



 
BeginGroup (

    DisplayGroup ( ) 

    DisplayGroupState ( DoNotPick )

)

.

.

.

EndGroup ( )